<html>

<head>
<meta http-equiv="Content-Language" content="en-us">
<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Tools/Search...</title>
<link rel="stylesheet" type="text/css" href="../explorer++.css">
<script language="javascript" src="../rollover.js"> </script>
</head>

<body onload="javascript:attachdiv()">

<table border="0" cellpadding="0" cellspacing="0" style="border-collapse: collapse" bordercolor="#111111" width="100%">
  <tr>
    <td valign="top">
    <h2><a name="top"></a><a href="../nav/mnu-tools.htm">Tools</a>/<img border="0" src="../images/icons/search.png" hspace="5" width="16" height="16">Search...</h2>
    </td>
    <td width="100" align="right">
    <img border="0" src="../images/keys/ctrl.png" width="48" height="45"><img border="0" src="../images/keys/f.png" width="45" height="45"><br>
    <img border="0" src="../images/keys/f3.png" width="45" height="45"></td>
  </tr>
</table>
<p><b>Click</b> or <b><i>Hover</i></b> on an item for more ...<br>
<map name="FPMap0">
<area coords="76, 43, 465, 64" shape="rect" onmouseover="javascript:rollovr(this,'{7}/390x22.png','#filename','{1}')">
<area coords="76, 72, 465, 93" shape="rect" onmouseover="javascript:rollovr(this,'{7}/390x22.png','#directory','{1}')">
<area coords="477, 72, 505, 94" shape="rect" onmouseover="javascript:rollovr(this,'{7}/29x23.gif','#directory','{1}')">
<area coords="20, 122, 89, 138" shape="rect" onmouseover="javascript:rollovr(this,'{22}/70x17.gif','#attrib','{1}')">
<area coords="20, 143, 89, 159" shape="rect" onmouseover="javascript:rollovr(this,'{22}/70x17.gif','#attrib','{1}')">
<area coords="106, 122, 175, 138" shape="rect" onmouseover="javascript:rollovr(this,'{22}/70x17.gif','#attrib','{1}')">
<area coords="106, 143, 175, 159" shape="rect" onmouseover="javascript:rollovr(this,'{22}/70x17.gif','#attrib','{1}')">
<area coords="215, 122, 319, 138" shape="rect" onmouseover="javascript:rollovr(this,'{22}/105x17.gif','#case','{1}')">
<area coords="215, 143, 324, 159" shape="rect" onmouseover="javascript:rollovr(this,'{22}/110x17.gif','#subfldrs','{1}')">
<area coords="340, 122, 479, 138" shape="rect" onmouseover="javascript:rollovr(this,'{22}/140x17.gif','#regex','{1}')">
<area coords="15, 183, 506, 330" shape="rect" onmouseover="javascript:rollovr(this,'{7}/492x148.png','#results','{1}')">
<area coords="12, 338, 248, 357" shape="rect" onmouseover="javascript:rollovr(this,'{7}/237x20.gif','#x','test:status')">
<area coords="349, 394, 421, 414" shape="rect" onmouseover="javascript:rollovr(this,'{23}/73x21.gif','#x','Commence (or Stop) file search')">
<area coords="431, 394, 503, 414" shape="rect" onmouseover="javascript:rollovr(this,'{23}/73x21.gif','#x','{8}')">
<area coords="502, 408, 518, 424" shape="rect" onmouseover="javascript:rollovr(this,'{7}/17x17_grip.gif','#x','{9}')">
</map>
<img id="MAINimg" border="0" src="../images/mnu_tools/search.png" usemap="#FPMap0" width="523" height="429"></p>
<p>The Search dialog provides a quick and convenient way to locate files or 
folders, based on a search <i>pattern</i> (partial name, etc.).&nbsp; The 
results area provides standard <i>Shell</i> context menus for each item found, 
allowing you to view, edit, copy, delete, etc. the files or folders.</p>
<table border="0" style="border-collapse: collapse" bordercolor="#111111" cellspacing="0" cellpadding="0">
  <tr>
    <td width="34" align="center">
    <img border="0" src="../images/common/info24x24.gif" hspace="0" width="24" height="24"></td>
    <td width="3" bgcolor="#0000FF">&nbsp;</td>
    <td width="10">&nbsp;</td>
    <td><b><font color="#0000FF" size="3">Info:</font></b> The Search routine 
    can <b>only</b> find files/folders by name or attributes; no searching for 
    text <b>within</b> a file can be done.</td>
  </tr>
</table>
<p>&nbsp;</p>
<h3><a name="filename"></a>Filename</h3>
<p>This field contains either</p>
<ul>
  <li>the partial file name (or search <i>pattern</i>) to search for.&nbsp; 
  Although <a href="../mnu_selection/wildcard_sel.htm#about">wildcard <i>
  patterns</i></a> may be used, it is not strictly necessary to do so; the 
  search implemented here will match a <b>partial</b> filename (similar to the 
  built-in Windows search tool) without using wildcard characters.&nbsp; A <i>
  drop-down</i> list is available with quick access to previous search <i>
  patterns</i>.&nbsp; If using a partial file name (or wildcard) <i>pattern</i> 
  here, make sure the <a href="#regex">Use Regular Expressions</a> checkbox is 
  not checked to prevent the pattern from being interpreted as a regular 
  expression.</li>
</ul>
<blockquote>
  <p>or</p>
</blockquote>
<ul>
  <li>a regular expression to match.&nbsp; Using a regular expression requires 
  the <a href="#regex">Use Regular Expressions</a> checkbox be checked.</li>
</ul>
<table border="0" style="border-collapse: collapse" bordercolor="#111111" cellspacing="0" cellpadding="0">
  <tr>
    <td width="34" align="center">
    <img border="0" src="../images/common/tip19x32.gif" hspace="0" width="19" height="32"></td>
    <td width="3" bgcolor="#FFFF00">&nbsp;</td>
    <td width="10">&nbsp;</td>
    <td><b><font size="3">Tip:</font></b> The <b>Filename:</b> field is also 
    used for entering Regular Expressions, which can be quite long.&nbsp; 
    Currently, this field does not scroll, so your long expression may not be 
    possible to enter.&nbsp; Simply resize the whole window (larger) for more 
    room in the edit box.</td>
  </tr>
</table>
<p>&nbsp;</p>
<h3><a name="directory"></a>Directory</h3>
<p>This field should contain the folder in which to perform the search, or the 
parent folder, if the <a href="#subfldrs">Search Subfolders</a> box is checked.&nbsp; 
The button beside the field opens a Windows <i>Browse For Folder</i> dialog (see
<a href="general/def_new_tab.htm#tip">tip</a> for a picture of this Windows 
dialog), allowing the user to navigate to and set the <b>Search Directory</b>.&nbsp; 
A <i>drop-down</i> list is available with quick access to previous search 
directories.</p>
<p>The <b>Search Directory</b> defaults to the folder/directory of the currently 
active tab.</p>
<p>&nbsp;</p>
<h3><a name="attrib"></a>Attributes</h3>
<p>Checking any <a href="../mnu_file/set_file_attr.htm#attrib">attributes </a>
provides a filtering mechanism; files searched must satisfy the Filename <i>
pattern</i> AND the attributes if they are to be included in the results.</p>
<p>&nbsp;</p>
<h3><a name="case"></a>Case Insensitive</h3>
<p>The state of this checkbox determines whether text case (i.e. <i>UPPER</i> or
<i>lower</i> case) will be considered during the search.</p>
<ul>
  <li><b>checked</b> - searches are case insensitive, that is, <i>UPPER</i> and
  <i>lower</i> case are considered the same.&nbsp; Searching for &quot;gif&quot;, for 
  example, will also find &quot;GIF&quot; and &quot;Gif&quot;.</li>
  <li><b>not checked</b> - searches are case sensitive and the target and 
  results case must match exactly, that is, &quot;gif&quot; <font face="Arial">&#8800; &quot;GIF&quot; &#8800; 
  &quot;Gif&quot;.</font></li>
</ul>
<p>&nbsp;</p>
<h3><a name="subfldrs"></a>Search Subfolders</h3>
<p>Normally, the search would be done only in the scope of the folder shown as 
the <a href="#directory">Directory</a>.&nbsp; However, if this box is checked, 
all subfolders (and subfolders of subfolders, etc.) will be included in the 
search.&nbsp; Results can be from either the search Directory, or any subfolder.</p>
<p>&nbsp;</p>
<h3><a name="regex"></a>Use Regular Expressions</h3>
<p>If this box is checked, then the text entered in the <a href="#filename">
Filename</a> edit box is assumed to be a regular expression and the search is 
done using pattern matching instead of simple file name comparisons.&nbsp; 
Regular expressions, while appearing complicated to the user of text and 
wildcard expressions (e.g. &quot;*.jpg&quot;), can be a more flexible and powerful 
approach to searching for files and folders.&nbsp; Having this tool available - 
as well as <i>conventional</i> (i.e. non regular expression) text searching - 
provides superior capabilities and choice to the user.&nbsp; For an introduction 
(and reference) to the use of regular expressions in Search, see the
<a href="regex_primer.htm">Regular Expression Primer</a>.&nbsp; Regular 
Expression searches obey the settings of the <b>Attributes</b> and <b>Search 
type</b> checkboxes.</p>
<p>&nbsp;</p>
<h3><a name="results"></a>Results pane</h3>
<p>When the search is completed, this list shows the name and path (ie. 
location) of all files found which matched the criteria for (partial) name and 
attributes.&nbsp; The <b>Name</b> and <b>Path</b> columns are resizable, and <i>
sortable</i> (ascending or descending, by clicking on the column header) for 
convenience when numerous results are visible.</p>
<table border="0" style="border-collapse: collapse" bordercolor="#111111" cellspacing="0" cellpadding="0">
  <tr>
    <td width="34" align="center">
    <img border="0" src="../images/common/tip19x32.gif" hspace="0" width="19" height="32"></td>
    <td width="3" bgcolor="#FFFF00">&nbsp;</td>
    <td width="10">&nbsp;</td>
    <td>
    <p style="margin-bottom: -16"><b><font size="3">Tip:</font></b> Each file in 
    the Results pane has a context (ie. right-click) menu.&nbsp; Two items on 
    this menu are of particular interest:</p>
    <ul>
      <li><b>Open</b> - this opens the file in any application registered to 
      that file type or presents a dialog if the type is not registered.&nbsp; 
      This may also be accomplished by double-clicking on the file.</li>
      <li><b>Open file location</b> - this opens a new tab at the folder which 
      houses the file.&nbsp; The target file is already selected in the new tab.&nbsp; 
      If multiple files were selected originally, only a single tab is opened 
      and a single file selected.</li>
    </ul>
    <p style="margin-top: -16">This context menu is constructed from Windows <i>
    shell</i> associations; items present will vary with the file type.</td>
  </tr>
  <tr>
    <td align="center" colspan="4">&nbsp;</td>
  </tr>
  <tr>
    <td width="34" align="center">
    <img border="0" src="../images/common/info24x24.gif" hspace="0" width="24" height="24"></td>
    <td width="3" bgcolor="#0000FF">&nbsp;</td>
    <td width="10">&nbsp;</td>
    <td><b><font color="#0000FF" size="3">Info:</font></b> The Microsoft .NET 
    framework, when present on a system, creates a subfolder in the Windows 
    folder called &quot;<i>assembly</i>&quot;.&nbsp; The nature of the .NET installation 
    may interfere with <b>Explorer++</b> (Windows Explorer's exploration is <i>
    modified</i>) successfully browsing this folder.&nbsp; If this folder is 
    included in your search (usually by virtue of using the <a href="#subfldrs">
    Search Subfolders</a> option), some results unusual results (eg. incorrect 
    file names, locations) may be expected, but these erroneous results are 
    usually obvious.</td>
  </tr>
</table>
<p>&nbsp;</p>
<h3><a name="status"></a>Status:</h3>
<p>This area shows</p>
<ul>
  <li>the folder being searched (quickly!), as the search progresses,</li>
  <li>&quot;Cancelled.&quot; - if the user stopped the search prematurely (by clicking the 
  Stop button or by pressing <b>Enter</b> or <b>spacebar</b>), or</li>
  <li>the final count of folders and files found, when the search completes.</li>
</ul>
<p><a title="Top of page" href="#top" style="background-color:transparent">
<img border="0" src="../images/common/arrow_top.gif" width="23" height="23"></a></p>

</body>

</html>
